# Get asset warranties

Returns a filtered and paginated list of warranty documents associated with the specified general asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Applies filtering criteria from the request body
- Supports pagination using the start query parameter
- Retrieves warranty-type operational documents for the asset
- Returns structured operational document list response data
- Logs the action as an equipment warranty list view event

Endpoint: POST /api/v1/assets/general/{assetIdentifier}/warranties

## Query parameters:

  - `start` (integer)

## Path parameters:

  - `assetIdentifier` (string, required)

## Request fields (application/json-patch+json):

  - `dataFieldIds` (array,null)

  - `selectedIds` (array,null)

  - `assetId` (string,null)

  - `keyword` (string,null)

  - `sortColumn` (string,null)

  - `sortColumnId` (string,null)

  - `sortOrder` (string,null)

  - `fieldValues` (array,null)

  - `fieldValues.dataFieldId` (string)

  - `fieldValues.dataFieldValue` (string,null)

  - `fieldValues.dataFieldlabel` (string,null)

  - `fieldValues.dataFieldValueIds` (array,null)

  - `fieldValues.fromDate` (string,null)

  - `fieldValues.toDate` (string,null)

  - `fieldValues.dataFieldValueRangeType` (string,null)

  - `datafieldIds` (array,null)

  - `filter` (string,null)

## Response 200 fields (text/plain):

  - `data` (object)

  - `data.generalProperties` (array,null)

  - `data.generalProperties.name` (string,null)

  - `data.generalProperties.alias` (string,null)

  - `data.generalProperties.dataType` (string,null)

  - `data.generalProperties.propertyType` (string,null)

  - `data.generalProperties.isKeyData` (boolean)

  - `data.generalProperties.visibility` (boolean)

  - `data.generalProperties.dataFieldId` (string)

  - `data.generalProperties.uiProperties` (object)

  - `data.generalProperties.uiProperties.fullWidth` (boolean)

  - `data.generalProperties.uiProperties.columnWidth` (string,null)

  - `data.generalProperties.uiProperties.columnSpan` (integer,null)

  - `data.data` (array,null)

  - `data.data.operationalDocumentName` (string,null)

  - `data.data.operationalDocumentId` (string)

  - `data.data.operationalDocumentNumber` (string,null)

  - `data.data.documentNumber` (string,null)

  - `data.data.status` (object)

  - `data.data.status.statusId` (string)

  - `data.data.status.statusCode` (string,null)

  - `data.data.status.statusName` (string,null)

  - `data.data.status.statusColor` (string,null)

  - `data.data.additionalInfo` (array,null)

  - `data.data.additionalInfo.dataField` (string,null)

  - `data.data.additionalInfo.dataFieldId` (string)

  - `data.data.additionalInfo.dataIds` (array,null)

  - `data.data.additionalInfo.dataFieldValue` (any,null)

  - `data.data.additionalInfo.dataFieldName` (string,null)

  - `data.data.additionalInfo.dataValueFormated` (string,null)

  - `data.data.date` (string,null)

  - `data.data.validity` (string,null)

  - `data.data.expiryDate` (string,null)

  - `data.data.followupDate` (string,null)

  - `data.data.description` (string,null)

  - `data.data.operationalDocumentType` (object)

  - `data.data.operationalDocumentType.operationalDocumentTypeName` (string,null)

  - `data.data.operationalDocumentType.operationalDocumentTypeId` (string)

  - `data.data.operationalDocumentType.canRenew` (boolean)

  - `data.data.operationalDocumentType.canEditDocumentTypeNumber` (boolean)

  - `data.data.operationalDocumentCategory` (object)

  - `data.data.operationalDocumentCategory.operationalDocumentCategoryId` (string)

  - `data.data.operationalDocumentCategory.operationalDocumentCategoryName` (string,null)

  - `data.data.operationalDocumentCategory.operationalDocumentCategoryCode` (string,null)

  - `data.data.operationalDocuments` (array,null)

  - `data.data.validityInDays` (number)

  - `data.data.file` (object)

  - `data.data.file.fileName` (string,null)

  - `data.data.file.fileId` (string)

  - `data.data.file.fileSize` (string,null)

  - `data.data.file.dateAddedOn` (string,null)

  - `data.data.file.isLinkedDocument` (boolean)

  - `data.data.file.preview` (object)

  - `data.data.file.preview.hasFilePreview` (boolean)

  - `data.data.file.preview.hasFileThumbnail` (boolean)

  - `data.data.file.preview.previewURL` (string,null)

  - `data.data.file.preview.thumbnailUrl` (string,null)

  - `data.data.file.fileType` (object)

  - `data.data.file.fileType.fileTypeId` (string)

  - `data.data.file.fileType.fileTypeName` (string,null)

  - `data.data.file.fileType.fileTypeIconURL` (string,null)

  - `data.data.file.fileType.fileExtentions` (array,null)

  - `data.data.file.isImage` (boolean)

  - `data.data.file.isCadFile` (boolean)

  - `data.data.file.customProperties` (object,null)

  - `data.data.file.isEditable` (boolean)

  - `data.data.file.addedBy` (string,null)

  - `data.data.file.fileSizeInBytes` (integer)

  - `data.data.file.fileStatus` (object)

  - `data.data.file.fileStatus.statusId` (string)

  - `data.data.file.fileStatus.statusCode` (string,null)

  - `data.data.file.fileStatus.statusName` (string,null)

  - `data.data.file.fileStatus.statusColor` (string,null)

  - `data.data.file.revisionNumber` (integer)

  - `data.data.file.addedOn` (string,null)

  - `data.data.file.isFavorite` (boolean)

  - `data.data.file.folderPath` (string,null)

  - `data.data.file.categoryUniqueId` (string)

  - `data.data.file.categoryLevelOrdinal` (integer)

  - `data.data.file.documentNumber` (string,null)

  - `data.data.file.fileGroupId` (string)

  - `data.data.file.hasPermissionToUpdate` (boolean)

  - `data.data.file.responseDescription` (string,null)

  - `data.data.validFor` (object)

  - `data.data.validFor.period` (integer)

  - `data.data.validFor.interval` (string)

  - `data.data.responseDescription` (string,null)

  - `data.listProperties` (object)

  - `data.listProperties.totalCount` (integer)

  - `data.listProperties.currentStart` (integer)

  - `data.listProperties.currentLength` (integer)

  - `data.listProperties.pageCount` (integer)

  - `data.responseDescription` (string,null)

  - `message` (string,null)

  - `isError` (boolean)

  - `messageCode` (integer)

  - `status` (string,null)

  - `errorType` (string,null)

  - `traceid` (string,null)

  - `responseDescription` (string,null)